home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 46 / Amiga Format CD46 (1999-10-20)(Future Publishing)(GB)[!][issue 1999-12].iso / -serious- / programming / other / tandem / jottings / refsheet next >
Text File  |  1999-09-06  |  9KB  |  149 lines
  1. Quick Reference Sheet for tandem.library MACROs (RefSheet  v.0.00  27.11.97)
  2. ----------------------------------------------------------------------------
  3.  
  4. TLaschex     \1=addr of asc   A0 points past  D0 = val   EQ if zero
  5. TLaslfile    \1,\2=fil,dir prompts   \3hail strnum  \4=sv/ld  EQ if bad/canc
  6. TLaslfont    \1=num  (then call TLnewfont)   EQ=bad/canc
  7. TLassdev     no param      NE=yes
  8. TLattach     A5=wsuw   \1=addr \2=size no result (mem must be AllocVec)
  9. TLbad        \1=strnum
  10. TLbusy       no params  no result      (ok to call if already busy)
  11. TLbutmon     \1,\2=TLKeyboard D1,D2   EQ=no button, 1+=button 1+
  12. TLbutprt     no params  EQ if bad (resized)
  13. TLbutstr     \1=addr string w. \ separators    no result
  14. TLbuttxt     \1=addr string w. \ separators    EQ if bad (resized)
  15. TLchip       \1=bytes    D0=addr or EQ=bad
  16. TLclosefile  no params  no result    (ok to call if already closed)
  17. TLdata       \1=1st line \2=no. of lines (later call TLreqoff)  (EQ if bad)
  18. TLdropdown   \1=draw/drop \2=1st string \3=num strings
  19.              [\4=selected(1+) dflt 1] \5,\6=xpos,ypos
  20.              [\7=max chrs dflt=0=calc][\8=max drop 5 to 14, dflt 7 OR cycle]
  21.              if \1=draw, all regs saved, EQ if bad
  22.              if \1<>draw  D0=1+, 0 if none/canc
  23. TLellipse    \1,\2=centre \3,\4=axes \5,\6=min x,y \7,\8=max x,y
  24.              [\9 rastport] [\10=solid]  (no \10 if outline)(no \9 if AcWind)
  25.              EQ if window resized   (\9,\10 can be null)
  26. TLerror      no params  EQ=dos error found, when erron num in D0
  27. TLfloat      \1=addr in \2=addr out(.P type)12 bytes  EQ=bad  3(a1)=0 if=0
  28. TLfreebmap   \1=addr of bitmap  no result (must have been made w. AllocVec!)
  29. TLfsub       \1=fontnum  no result
  30. TLgetarea    \1,\2=min x,y \3,\4=max x,y \5=16 bytes for result  EQ if canc
  31.              (result: 0,4=topleft; 8,12=botright)
  32. TLgetfont    \1=name \2=number \3=height  (then call TLnewfont)
  33. TLgetilbm    \1=max planes, \2=790 byte buffer for BMHD,CMAP
  34.              [\3=nobody = don't load BODY]  [\4=public] if pub mem for bmap]
  35.              returns A0=bitmap if body loaded, else A0 unchanged  EQ if bad
  36. TLhexasc     \1=val \2=addr  A0 bypasses output
  37. TLhexasc16   \1=val \2=digts 1-8, or 0=left justify \3=addr  A0 bypasses opt
  38. TLinput      no params  no result
  39. TLkeyboard   no params  D0-D3=ascii mousex mousey bits
  40.              bits: 0shift 3ctrl 4alt 6leftamiga 7rightamiga
  41.              special ascii  retn$0D esc$1B lmb$80 F1=F10$81-$8A bs$8B tab$8C
  42.                             del$8D up$8E down$8F right$90 left$91 help$92
  43.                             close$93 gadup$94 size$96 inactive$97 boopsi$99
  44.                             menu$95, when d1,d2,d3=column,choice,sub -1=none
  45.                             scroll$98, when d1,d2 = horz top,vert top
  46. TLmget       no params    NE if message in D0-D3
  47. TLmultiline  \1= multiline forbids  \2=reqedit forbids   EQ if bad
  48.              #xxp_xmsty,#xxp_xesty for plaintext   set bit 31 of d0 for lock
  49. TLnewfont    \1=num \2=style [\3=0main/1req/2help dflt 0]  EQ=bad
  50. TLnm         \1=title/item/sub/end \2=labl str/-1 bar [\3flags [\4mut excl]]
  51. TLoffmenu    \1=menu \2=item \3=sub (-1 if n.a.)   }first call
  52. TLonmenu     \1=menu \2=item \3=sub (-1 if n.a.)   }TLreqmenu
  53. TLopenread   no params  EQ=bad     (calls TLclosefile if bad)
  54. TLopenwrite  no params  EQ=bad     (calls TLclosefile if bad)
  55. TLoutput     no params  no result
  56. TLoutstr     \1=strnum  no result
  57. TLpassword   \1=chrs    EQ if bad   D0=$1B if canc
  58. TLpict       \1=num(0-11) \1=xpos \2=ypos  EQ=bad
  59. TLprefdir    \1=dir addr  (excl ENV:)  \2=use/save
  60.              e.g. for ENV:Foo/Bar/Fred call w. Foo, Foo/Bar, then preffil
  61. TLpreffil    \1=path addr (excl ENV:)  \2=use/save  \3=addr  \4=bytes
  62. TLprefs      [\1=color to allow palette]  no result
  63. TLprogdir    no params  no result
  64. TLprogress   \1=progress \2=total [\3=txt] dflt no text
  65. TLpublic     \1=bytes   D0=addr or EQ=bad
  66. TLputilbm    \1,\2,\3,\4=where  \5=bitmap (xxp_Screen CMAP) filename in buff
  67. TLreadfile   \1=from \2=max bytes  EQ=bad  D0=bytes read (0=good)
  68. TLreqarea    \1,\2=posn \3,\4=size [\5=pen] [\6=rastport, no \6 AcWind]
  69.              EQ if window resized
  70. TLreqbev     \1,\2=posn \3,\4=size [\5=rec recessed, \5=box unbevelled]
  71.              [\6 rastport (no \6, AcWind)] [\7 front pen] [\8 back pen]
  72.              EQ if window resized
  73. TLreqchek    \1=width \2=height   EQ if won't fit
  74. TLreqchoose  \1=1st strnum [\2=no. choices(dflt 1,ignre \1)] D0=1+ or EQ=bad
  75. TLreqcls     no params  no result
  76. TLreqcolor   \1=0:pen only, 2:pen+palette, 3:palette only   1+=choice
  77.              (or, \1=-1 for load prefs palette, no result)
  78. TLreqedit    \1=tablet xpos \2=tablet ypos \3=tags (see end), or
  79.              \3=0/1 for default tags for plain/styl, when:
  80.              [\4=max chrs, dflt 20str,4num,8hex][\5=tablet width dflt none]
  81.              [\6=txt max width deflt none][\7=menu num dflt none]
  82.              [\8=str/num/hex dflt str]             EQ if bad
  83. TLreqfont    \1 = forbids:  bit 0-9 = fonts 0-9 (forbids load/reload them)
  84.              reuturns D0=0canc, 1-10 = font 0-9
  85. TLreqfull    no params  no result
  86. TLreqinfo    \1=strnum [\2=num strs(dflt 1) [\3=1/2/3(dflt 1) 1ok 2ok\canc]]
  87.               3=last str 1+ choices sep by \'s    result: D0=1+ or EQ=bad
  88. TLreqinput   \1=titl [\2=num/str/hex(dfl str) [\3=len(dfl str20 num4 hex8)]]
  89.               result  in D0 if num/hex  EQ=canc/bad (xxp_errn=0 if canc)
  90. TLreqmenu    \1=TLnm menu struc   EQ=bad    }sets up menu       }see also
  91. TLreqmuclr   no params  no result           }activates menu     }TLonmeu
  92. TLreqmuset   no params  no result           }inactivates menu   }TLoffmenu
  93. TLreqoff     no params  no result
  94. TLreqon      \1=dummy xxp_wsuw entry (TLreqredi first)   EQ=bad
  95. TLreqredi    \1=dummy xxp_wsuw entry
  96. TLreqshow    \1=hook \2=hail \3=total strs \4=strs fit [\5=init(dflt 0)]
  97.              set bit 31    of \3 for dumb  search, or append \6=seek
  98.              set bit 31,30 of \3 for smart search, or append \6=smart
  99.              on return, EQ=bad
  100.              hook on call: see D0 bits 31,30:
  101.                00 make string num D0 bits 0-29, rts w. string at (a0)
  102.                10 string bits 0-29 has been clicked, when return:
  103.                   D0-ve do nothing; D0=0 quit; D0=1 redraw w. no comp
  104.                   D0=2 redraw w. comp; D0=3 redraw, use D1,D3 as new \3,\5
  105.                11 do smart search from bits 0-29
  106.                   D1 = 3/4/5 = fore/back/left, sought in xxp_patt(a4)
  107.                   return D0 = where, or D0=-1 = unfound, or D0=-2 = do dumb
  108. TLresize     \1,\2=topleft \3,\4=oldsize \5,\6=newsize [\7=BgPen dflt 0]
  109.              [\8=rastport] if no \8, uses AcWind   EQ = widow resized
  110. TLscreen     \1=planes  \2=title  \3=pens  [\4=DisplayID dflt HIRES]  EQ=bad
  111. TLslider     \1=window wsuw  EQ=bad
  112. TLslimon     \1-\3=callinf TLkeyboard D1-D3, A5=AcWind  EQ=no,NE=yes
  113. TLstra0      \1=strnum  no result
  114. TLstring     \1=strnum \2=xpos \3=ypos  no result
  115. TLstrbuf     \1=strnum  no result
  116. TLtabmon     \1,\2=TLkeyboard D1,D2; \2,\3=xpos,ypos
  117.              returns EQ,D0=0 if none clicked, else NE, D0=1+
  118. TLtabs       setup:  \1=strnum  \2=minwidth  \3=body height
  119.              render: \1=0  \2=frontcard(1+)  \3=xpos  \4=ypos  (EQ=bad)
  120.              kill:   \1=0  \2=0              \3=xpos  \4=ypos
  121. TLtext       \1=xpos \2=ypos  no result
  122. TLtrim       \1=xpos \2=ypos    EQ=bad(resized)
  123. TLtsize      no params  D4=width D5=chrs D6=font ht D7=font baseline
  124. TLunbusy     no params   no result    (ok to call if already unbusy)
  125. TLwcheck     no params   EQ=same
  126. TLwclose     no params   no result    (Front.i calls automatically)
  127. TLwfront     no params   no result
  128. TLwindow     \1=num \2,\3=where \4,\5=min \6,\7=max \8=flags \9=title EQ=bad
  129.              \8=0 for normal; \8=1 for borderless \8=-1 for scrollers
  130. TLwindow0    no parmams (needs st_1=title)  EQ=bad
  131. TLwpoll      no params  D0-D3 per TLMmess (i.e. popped window TLkeyboard)
  132. TLwpop       \1=num  no result
  133. TLwritefile  \1=from \2=bytes  EQ=bad (calls TLclosefile if bad)
  134. TLwscroll    \1=set/get  Data in xxp_scrl: set sets all, get sets hztp,vttt
  135.              \2=vert/both/horz (default both)
  136. TLwslof      no params  no result
  137. TLwsub       \1=num  no result
  138. TLwupdate    no params  no result
  139.  
  140. TLreqedit tags,styl bits....
  141.   xxp_xtext dflt xxp_FWork xxp_xoffs xxp_xcspc xxp_xtral xxp_xfgbg xxp_xfont
  142.   xxp_xstyl dflt all 0     xxp_xforb xxp_xmaxj xxp_xunpk xxp_xffix xxp_xresz
  143.   xxp_xmaxt tablet width   xxp_xcomp xxp_xkybd xxp_xpack xxp_xjam1 xxp_xmenu
  144.   xxp_xmaxc max chrs 1-254 xxp_xstyb xxp_xredo xxp_xiclr xxp_xcase xxp_xmaxw
  145.   xxp_xcrsr 0+, 255=eol, -1none   OR   xxp_nprt=-1=don't print
  146.   xxp_xtask 0=ascii no cont 1=ascii w. cont 2=dec num 3=hex num
  147.   xxp_xltyp 0=ljust 1=centre 2=rjust 3=full just
  148. styl bits: 0bold 1ital {2undl 3sup 4sub 5dotd (&c)} 5shad 6wide
  149.